home *** CD-ROM | disk | FTP | other *** search
/ Eyewitness Photo Gallery 2: Birds / Eyewitness Photo Gallery - Volume 2 - Birds.iso / mac / Support / MStools / README.TXT < prev    next >
Text File  |  1994-04-13  |  14KB  |  348 lines
  1. ======================================================================
  2.                WW0440: THE DRWATSON AND MSD DIAGNOSTICS
  3. ======================================================================
  4.                                                    Revision Date: 4/94
  5. ---------------------------------------------------------------------
  6. | INFORMATION PROVIDED IN THIS DOCUMENT AND ANY SOFTWARE THAT MAY    |
  7. | ACCOMPANY THIS DOCUMENT (collectively referred to as an            |
  8. | Application Note) IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY      |
  9. | KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING BUT NOT LIMITED TO    |
  10. | THE IMPLIED WARRANTIES OF MERCHANTABILITY AND/OR FITNESS FOR A     |
  11. | PARTICULAR PURPOSE. The user assumes the entire risk as to the     |
  12. | accuracy and the use of this Application Note. This Application    |
  13. | Note may be copied and distributed subject to the following        |
  14. | conditions: 1) All text must be copied without modification and    |
  15. | all pages must be included; 2) If software is included, all files  |
  16. | on the disk(s) must be copied without modification [the MS-DOS(R)  |
  17. | utility DISKCOPY is appropriate for this purpose]; 3) All          |
  18. | components of this Application Note must be distributed together;  |
  19. | and 4) This Application Note may not be distributed for profit.    |
  20. |                                                                    |
  21. | Copyright 1991 Microsoft Corporation. All Rights Reserved.         |
  22. | Microsoft and MS-DOS are registered trademarks and Windows is a    |
  23. | trademark of Microsoft Corporation.                                |
  24. | Novell is a registered trademark of Novell, Inc.                   |
  25.  --------------------------------------------------------------------
  26.  
  27. Introduction
  28. ------------
  29.  
  30. The disk included with this application note contains DrWatson and
  31. MSD, two programs that aid Microsoft programmers in debugging Windows.
  32. DrWatson is a program that logs information about conditions that
  33. exist when an unrecoverable application error (UAE) occurs. MSD
  34. (Microsoft Diagnostics) is a program that identifies system
  35. configuration information.
  36.  
  37. This application note explains how to install and use DrWatson and
  38. MSD. For Microsoft to most effectively identify and solve system
  39. problems, we ask that you use these programs and periodically send us
  40. the logs that result. The information in this application note
  41. describes what to do when a UAE occurs and how to send Microsoft the
  42. information that you gather.
  43.  
  44. DrWatson
  45. --------
  46.  
  47. DrWatson is a debugging tool designed to provide software programmers
  48. with detailed information on the internal state of Windows when a UAE
  49. occurs. DrWatson must be running at the time a UAE occurs to extract
  50. the internal information from the system.
  51.  
  52. As DrWatson uses very little memory and does not affect the
  53. performance of Windows, we encourage you to install DrWatson if a UAE
  54. has occurred before. After DrWatson is installed, information is
  55. collected when a UAE occurs and written to a special file
  56. (DRWATSON.LOG) located in the Windows directory.
  57.  
  58. DrWatson is a diagnostic tool, not a cure for a problem. Having
  59. DrWatson will not prevent an error from occurring, but the information
  60. in DRWATSON.LOG will help Microsoft developers make the next version
  61. of Windows even better.
  62.  
  63. Microsoft Diagnostics (MSD)
  64. ---------------------------
  65.  
  66. The Microsoft Diagnostics (MSD) program is designed to assist
  67. Microsoft customers and Product Support Services (PSS) technicians in
  68. solving problems with Microsoft products. MSD identifies system
  69. configuration information such as the BIOS, video card type and
  70. manufacturer, installed processor(s), I/O port status, operating
  71. system version, environment settings, hardware devices attached, and
  72. additional software running concurrently with MSD.
  73.  
  74. MSD should be used in conjunction with DrWatson to provide valuable
  75. information on hardware configurations and UAEs. Error reports should
  76. include information from both the MSD program and DrWatson. (The
  77. section titled "When a UAE Occurs" on page 2 of this application note
  78. details the procedure for using MSD with DrWatson.)
  79.  
  80. Installing DrWatson and MSD
  81. ---------------------------
  82.  
  83. We recommend that you start DrWatson automatically each time you start
  84. Windows. This will allow you to collect critical information each time
  85. a UAE occurs.
  86.  
  87. To install MSD and DrWatson and to start DrWatson automatically when
  88. you start Windows, do the following:
  89.  
  90. 1. Place the enclosed disk in drive A.
  91.  
  92. 2. From Windows, start File Manager.
  93.  
  94. 3. From the File menu, choose Copy. In the From and To boxes, type the
  95.    following:
  96.  
  97.       From:  a:\msd.exe
  98.       To:    c:\
  99.       
  100.    Choose the Copy button. The MSD program is now copied to your root
  101.    directory (if your root directory is not on drive C, substitute the
  102.    correct drive letter in the To box).
  103.  
  104. 4. From the File menu, choose Copy. In the From box, type the
  105.    following:
  106.  
  107.       a:\drwatson.exe a:\toolhelp.dll
  108.  
  109.    In the To box, type in the path to your Windows directory (for
  110.    example: "c:\windows" -- without the quotation marks). Choose the
  111.    Copy button. The DrWatson files are now copied to your Windows
  112.    directory.
  113.  
  114. 5. From the File menu, choose Copy. Make a backup copy of your WIN.INI
  115.    file. For example, if your Windows directory is called Windows and
  116.    is on drive C, in the From and To boxes, type the following:
  117.  
  118.       From:  c:\windows\win.ini
  119.       To:    c:\windows\win.bak
  120.  
  121.    Choose the Copy button.
  122.  
  123. 6. Exit File Manager and open Notepad or any text editor. Open the
  124.    WIN.INI file, and in the [Windows] section, add DrWatson to the
  125.    LOAD= line. For example:
  126.  
  127.       [windows]
  128.       Beep=yes
  129.       Spooler=yes
  130.       NullPort=None
  131.       LOAD=DRWATSON.EXE
  132.  
  133. 7. Save the WIN.INI file and exit the text editor.
  134.  
  135. 8. Exit and then restart Windows.
  136.  
  137. DrWatson should now appear as an icon on your desktop.
  138.  
  139. Using DrWatson
  140. --------------
  141.  
  142. DrWatson adds a file to your Windows directory called DRWATSON.LOG. If
  143. a UAE occurs while DrWatson is running, DrWatson captures data
  144. regarding the internal operations of Windows. In addition, DrWatson
  145. prompts you for details on how the UAE occurred. When you type in your
  146. response, please include information on what you were doing or what
  147. steps created the UAE. This information is recorded in the
  148. DRWATSON.LOG file and will help our software programmers track the
  149. problems.
  150.  
  151. At this time, DrWatson does not detect all system errors, so don't be
  152. alarmed if DrWatson does not record information after a particular
  153. system error.
  154.  
  155. Each time a UAE occurs, DrWatson appends new data to DRWATSON.LOG. To
  156. prevent this file from growing too large and to aid our processing,
  157. please save DRWATSON.LOG as a different file periodically. (For
  158. example, if five UAEs occur in one day, save DRWATSON.LOG under a
  159. different name before you start Windows again the next day.)
  160.  
  161. To save the file under a different name, type the following at the
  162. command prompt before you start Windows:
  163.  
  164.    rename c:\drwatson.log <newname>
  165.  
  166. where <newname> is any legal MS-DOS filename, such as SEPT06.LOG. If
  167. your root directory is not on drive C, substitute the correct drive
  168. letter.
  169.  
  170. When a UAE Occurs
  171. -----------------
  172.  
  173. 1. When a UAE occurs, the DrWatson dialog box will appear. Type in a
  174.    description of what you were doing prior to receiving the error.
  175.    Press ENTER.
  176.  
  177. 2. Exit Windows if possible. If exiting is not possible, restart your
  178.    computer.
  179.  
  180. 3. Change to the root directory, and at the command prompt, type "msd"
  181.    (without the quotation marks) and press ENTER to run the MSD
  182.    program. (For LCD and monochrome screens, type "msd /b" and press
  183.    ENTER.)
  184.  
  185. 4. Press R to choose Generate Report. Select the Generate To File
  186.    option. When prompted for a filename, type "msd.log" (without the
  187.    quotation marks and press ENTER. Fill in the information requested.
  188.  
  189. 5. Exit MSD by pressing X.
  190.  
  191. 6. Append the MSD log to the DrWatson log by typing the following at
  192.    the command prompt:
  193.  
  194.       type <path>\MSD.LOG >> <path\drwatson>
  195.  
  196.    where <path\drwatson> is the path and filename of the DrWatson log.
  197.    For example, if you named your DrWatson log the default
  198.    DRWATSON.LOG (in the WINDOWS directory on drive C), type the
  199.    following:
  200.  
  201.       type c:\msd.log >> c:\windows\drwatson.log
  202.  
  203. 7. After you have logged several UAEs, send us the log by following
  204.    the instructions listed on page 4 of this application note.
  205.  
  206. 8. After sending us the log, delete the MSD and DrWatson logs (for
  207.    example, MSD.LOG and DRWATSON.LOG) from your hard disk.
  208.  
  209. More Information About Using the Microsoft Diagnostics Program
  210. --------------------------------------------------------------
  211.  
  212. The MSD program runs with MS-DOS and the DOS compatibility box of
  213. OS/2.
  214.  
  215. MSD presents a Main Menu screen split into two sections. The upper
  216. section presents a summary of information that the utility has
  217. gathered from your system. For additional information on any category,
  218. use the quick key commands, or move the highlight bar (using the arrow
  219. keys) to any category and press the ENTER key. A dialog box appears
  220. that presents detailed information for that category. Return to the
  221. Main Menu screen by pressing the ESC key.
  222.  
  223. The following is a brief explanation of the categories in the first
  224. section of the MSD program:
  225.  
  226.    Category           Description
  227.    --------           -----------
  228.    
  229.    BIOS               Displays the BIOS manufacturer, date, version,
  230.                       and type
  231.  
  232.    Processor          Displays the processor type and math
  233.                       coprocessor, if installed
  234.  
  235.    Memory             Displays a map of memory from 768K to 1 MB and
  236.                       information concerning the configuration of RAM
  237.                       and ROM in your computer system
  238.  
  239.    Video              Shows your video card's manufacturer and model,
  240.                       BIOS version, memory, and current video mode
  241.  
  242.    Network            Detects whether a network is MS-Net or
  243.                       compatible, or Novell
  244.  
  245.    Mouse              Shows the DOS mouse driver version number, mouse
  246.                       type, and other information concerning the mouse
  247.  
  248.    Game Adapter       Dynamically displays game card status for up to
  249.                       two game devices or joysticks
  250.  
  251.    CD-ROM             Displays the Microsoft CD-ROM Extensions
  252.                       (MSCDEX.EXE) version number and drive letter
  253.  
  254.    Operating System   Displays the operating system version number and
  255.                       path from which MSD was run
  256.  
  257.    Parallel Ports     Dynamically displays the status of installed
  258.                       parallel ports and their port addresses    
  259.  
  260.    Serial Ports       Dynamically displays the status of active serial
  261.                       ports and their current configurations
  262.  
  263.    Disk Drives        Scans all local and logical drives and displays
  264.                       the total and available bytes
  265.  
  266.    IRQ Status         Shows the current IRQ (hardware interrupt)
  267.                       status
  268.  
  269.    Environment        Displays environment variables
  270.  
  271.    AUTOEXEC.BAT       Lists the AUTOEXEC.BAT file
  272.  
  273.    CONFIG.SYS         Lists the CONFIG.SYS file
  274.  
  275. The lower section of the MSD screen includes additional functions you
  276. can use with your system, as follows:
  277.  
  278.    Function           Description
  279.    --------           -----------
  280.    
  281.    Resident Programs  Displays the names of programs loaded in RAM at
  282.                       the time MSD was executed, their locations, and
  283.                       their sizes; programs may be loaded into
  284.                       multiple segments of RAM and have multiple
  285.                       entries in the table
  286.  
  287.    Device Table       Displays software and hardware device drivers
  288.                       installed; these include default devices, such
  289.                       as COM1 or LPT1, and user-installed devices
  290.                       loaded from the CONFIG.SYS file, such as
  291.                       HIMEM.SYS or EMM386.SYS
  292.  
  293.    Printer Test       Prints a page to test the connection between the
  294.                       computer and either a TTY or PostScript-type
  295.                       printer
  296.  
  297.    Generate Report    Prints a "faxable" report to a normal TTY
  298.                       printer or to a file
  299.  
  300.    File Viewer        Views text files by entering the path and
  301.                       filename
  302.  
  303.    Memory Browser     Searches selected ROM and RAM areas for search
  304.                       strings such as "Copyright" and "Version"
  305.  
  306.    About              Displays the MSD version number and copyright
  307.                       information
  308.  
  309.    Exit               Exits MSD
  310.  
  311. Sending Information Gathered by DrWatson and MSD to Microsoft
  312. -------------------------------------------------------------
  313.  
  314. Electronic format is currently the only way we can accept DrWatson log
  315. information. This means we can receive log data by disk, through
  316. CompuServe, or through electronic mail. In all cases, we require your
  317. company name, address, and the name and phone number of a person we
  318. can contact in the event we need additional data.
  319.  
  320. You can use any of the following methods to send the report results to
  321. us:
  322.  
  323. 1. Send a disk containing the DrWatson log(s) to the following mailing
  324.    address:
  325.  
  326.       Microsoft Corporation
  327.       Attn: Dr. Watson Program
  328.       One Microsoft Way, Building #3
  329.       Redmond, WA 98052-6399
  330.       
  331. 2. Send the information in the DrWatson log(s) via email to Watson at
  332.    Microsoft. Our Internet address is watson@microsoft.com.
  333.  
  334. 3. Post the data contained in the DrWatson log(s) in the WINADV forum,
  335.    Library 17, in the Microsoft Windows section on CompuServe. In
  336.    CompuServe, type the following to get to the forum:
  337.  
  338.       go winadv
  339.  
  340. After you have sent us the log file(s) by one of the methods described
  341. above, delete all of the log files from your hard disk to free up disk
  342. space.
  343.  
  344. Unfortunately, we cannot respond to log contributors, but we will
  345. review every DrWatson file and actively work on solving reported
  346. problems. We thank you in advance for your efforts. Your help will
  347. enable us to keep improving future versions of Windows.
  348.